home *** CD-ROM | disk | FTP | other *** search
- .\" @(*) tmac.an 1.2p0 92/7/14 rosenkra
- .\" **************************************************************************
- .\" -man package for nroff. almost unix(tm), adequate/working...
- .\"
- .\" note: needs .tm for .IX and .CX, also uses .ie/.el
- .\"
- .\" usage: nroff -man file
- .\" installed path: c:\lib\tmac\tmac.an (TMACDIR)
- .\" user macros: TH, SH, SS, IP, HP, PP, LP, RS, RE, IX, CX
- .\" R, I, B, SM, IR, RI, BR, RB, BI, IB, PD
- .\" extensions: EX, Th, pp, RP
- .\" no-ops:
- .\" debuging: }D
- .\" internal macros: none
- .\" strings used: S, ux, lq, rq, `, ', DW, Dy, Da, Yr, DY, TM, DA, CT,
- .\" Se
- .\" registers used: I, D, M, O, X, Z (user can set O for online)
- .\" bugs: IP does not place short tags on same line.
- .\" no TP, DT.
- .\" no \*R (macros and strings share namespace).
- .\" notes: change all "0.8i" below to "0.5i" for more unix-like
- .\" compatability
- .\" author: rosenkra@convex.com (Bill Rosenkranz)
- .\" version: for ST nroff v1.2p0
- .\" date: 92/7/14
- .\" restrictions: none. freely distributable (no copyright, etc.)
- .\"
- .\" **************************************************************************
- .\"
- .\" control
- .\"
- .\" set register O on command line (-rO1) to make manpage for online viewing
- .\" i.e. without headers/footers and with exit macro. or else make $6 in TH
- .\" "ONLINE" to do the same. this sets register X to 1.
- .\"
- .\" set this >0 to turn on debugging
- .nr Z 0
- .\" set this >0 for use with manpager(1) (sets special chars, fonts)
- .nr M 1
- .\" set paragraph distance
- .nr D 1
- .\" set relative indent register
- .nr I 0
- .\"
- .\" **************************************************************************
- .\"
- .\" some predefined strings (quotes, etc)
- .\"
- .ds Me tmac.an
- .ie \nM>0 \{\
- .\". ds R
┐ - . ds S s
- . ds lq
! - . ds rq
" - . ds `
` - . ds '
' - . ds ux Unix
┐ - \}
- .el \{\
- .\". ds R (Reg)
- . ds S s
- . ds lq ""
- . ds rq ""
- . ds ` `
- . ds ' '
- . ds ux Unix(tm)
- \}
- .\"
- .\" these are various predefined date and time strings
- .\"
- .\" DW day-of-week:
- .if \n(dw=1 .ds DW "Sun
- .if \n(dw=2 .ds DW "Mon
- .if \n(dw=3 .ds DW "Tue
- .if \n(dw=4 .ds DW "Wed
- .if \n(dw=5 .ds DW "Thu
- .if \n(dw=6 .ds DW "Fri
- .if \n(dw=7 .ds DW "Sat
- .\" Dy month day:
- .if \n(mo=1 .ds Dy "Jan \n(dy
- .if \n(mo=2 .ds Dy "Feb \n(dy
- .if \n(mo=3 .ds Dy "Mar \n(dy
- .if \n(mo=4 .ds Dy "Apr \n(dy
- .if \n(mo=5 .ds Dy "May \n(dy
- .if \n(mo=6 .ds Dy "Jun \n(dy
- .if \n(mo=7 .ds Dy "Jul \n(dy
- .if \n(mo=8 .ds Dy "Aug \n(dy
- .if \n(mo=9 .ds Dy "Sep \n(dy
- .if \n(mo=10 .ds Dy "Oct \n(dy
- .if \n(mo=11 .ds Dy "Nov \n(dy
- .if \n(mo=12 .ds Dy "Dec \n(dy
- .ds Da "\n(hh:\n(mm:\n(ss \n(mo/\n(dy/\n(yr
- .ds Yr "19\n(yr
- .ds DY "\*(Dy, \*(Yr
- .ds TM "\n(hh:\n(mm:\n(ss
- .ds DA "\*(TM \*(DY
- .ds CT "\*(DW \*(Dy \*(TM 19\n(yr
- .\"
- .\" they look like this:
- .\"
- .\" DW Sun
- .\" Dy Mar 4
- .\" DY Mar 4, 1990
- .\" Yr 1990
- .\" TM 16:34:00
- .\" DA 16:34:00 Mar 4, 1990
- .\" Da 16:34:00 2/4/90
- .\" CT Sun Mar 4 16:34:00 1990 like ctime(2)
- .\"
- .\" **************************************************************************
- .\"
- .\" startup stuff...
- .\"
- .\" X is number register used internally here. it is initially 0. it gets
- .\" set to 1 in TH if ONLINE is set. it is used in the EX macro to force
- .\" an immediate exit at the end. user can also force ONLINE with -rO1.
- .\"
- .in 0.0i
- .po 0.0i
- .lt 7.2i
- .ll 7.2i
- .m1 3
- .m2 3
- .m3 3
- .m4 3
- .nr X 0
- .\" set exit macro (mainly for ONLINE, no-op if not)
- .em EX
- .\"
- .\" **************************************************************************
- .\"
- .\" MACROS...
- .\"
- .\" ----------------------------------------------------------------------- TH
- .\" main page heading
- .\"
- .\" fields are usually: 1-name, 2-section, 3-section name, 4-version, 5-date
- .\" 1,2,3 are on header, 4,5 and page on footer. empty strings are skipped
- .\" by making the arg "". this must be first! there is an extra field at the
- .\" end ($6) which, if "ONLINE", prints the page without page breaks (i.e.
- .\" headers/footers).
- .\"
- .\" $1 $2 $3
- .\" | | |
- .\" v v v
- .\" NAME (1) Section NAME (1)
- .\" ...
- .\" Version Date Page n
- .\" ^ ^
- .\" | |
- .\" $4 $5
- .\"
- .\" .TH NAME 1 "Commands" "Version 1.0" "7 March 1990" ["ONLINE"]
- .\"
- .\" there is an extension here: if the 6th argument is "ONLINE" then the
- .\" resultant output does not have any headers/footers. this is useful for
- .\" making manpages for online use.
- .\"
- .de TH
- .if \n(.$<2 \{\
- . sp 2
- \&\*(Me: FATAL ERROR, too few args for TH
- . sp 2
- . ex
- \}
- .if !\nO>0 \{\
- .\" define Se as default chapter name based on input chapter number
- . if $2=0 .ds Se "General Information
- . if $2=1 .ds Se "Commands and Applications
- . if $2=2 .ds Se "System Calls
- . if $2=3 .ds Se "Library Calls
- . if $2=4 .ds Se "Hardware and Special Files
- . if $2=5 .ds Se "File Formats
- . if $2=6 .ds Se "Games
- . if $2=7 .ds Se "Miscellaneous
- . if $2=8 .ds Se "Administation Commands
- \}
- .\" if the 6th arg is "ONLINE", set up for online docs output (no head/foot)
- .\" the X reg is used by macro EX (exit). the user can force ONLINE by
- .\" setting reg "O" on cmdline (-rO1)
- .if \n(.$>5 .if "$6"ONLINE" .nr O 1
- .ie \nO>0 \{\
- .\" no headers of footers (ONLINE)
- . m1 0
- . m2 0
- . m3 0
- . m4 0
- . nr X 1
- \}
- .el \{\
- .\" set page len, include headers of footers (!ONLINE)
- . pl 66
- . if \n(.$<3 .tl |$1($2)|\*(Se|$1($2)|
- . if \n(.$>2 .if !"$3"" .tl |$1($2)|$3|$1($2)|
- . if \n(.$>2 .if "$3"" .tl |$1($2)|\*(Se|$1($2)|
- . if \n(.$<4 .fo |Atari ST|Printed: \*(DY|Page %|
- . if \n(.$<5 .if "$4"" .fo |Atari ST|Printed: \*(DY|Page %|
- . if \n(.$<5 .if !"$4"" .fo |$4|Printed: \*(DY|Page %|
- . if \n(.$>4 .if !"$4"" .if !"$5"" .fo |$4|Release: $5|Page %|
- . if \n(.$>4 .if !"$4"" .if "$5"" .fo |$4|Printed: \*(DY|Page %|
- . if \n(.$>4 .if "$4"" .if !"$5"" .fo |Atari ST|Release: $5|Page %|
- . if \n(.$>4 .if "$4"" .if "$5"" .fo |Atari ST|Printed: \*(DY|Page %|
- \}
- .in 0.8i
- ..
- .\" ----------------------------------------------------------------------- Th
- .\" alternate main page heading
- .\"
- .\" this prints no header/footer so it is good for creating online docs
- .\" for man(1). it ignores all args.
- .\"
- .\" .Th NAME 1
- .\"
- .de Th
- .m1 0
- .m2 0
- .m3 0
- .m4 0
- .in 0.8i
- .nr X 1
- ..
- .\" ----------------------------------------------------------------------- EX
- .\" exit NOW if ONLINE. (no extra space at end of document)
- .\"
- .de EX
- .if \nX>0 \{\
- . sp
- . fl
- . ex
- \}
- ..
- .\" ----------------------------------------------------------------------- PD
- .\" set paragraph distance
- .\"
- .de PD
- .ie \n(.$=0 .nr D 1
- .el .nr D $1
- ..
- .\" ----------------------------------------------------------------------- RS
- .\" start relative indent. does not add space.
- .\"
- .de RS
- .br
- .\" .sp 1
- .ie \n(.$=0 \{\
- . in +0.8i
- . nr I +0.8i
- \}
- .el \{\
- . in +$1
- . nr I +$1
- \}
- ..
- .\" ----------------------------------------------------------------------- RE
- .\" end relative indent. does not add space.
- .\"
- .de RE
- .br
- .ie \n(.$=0 \{\
- . in -0.8i
- . nr I -0.8i
- \}
- .el \{\
- . in -$1
- . nr I -$1
- \}
- ..
- .\" ----------------------------------------------------------------------- IP
- .\" indented paragraph with tag (from this line)
- .\"
- .de IP
- .\" new version, with indent as $2. tag MUST be quoted to include blanks...
- .br
- .if \nD>0 \{\
- . sp \nD
- \}
- .in 0.8i
- .in +\nI
- .if \n(.$>0 .if !"$1"" \&$1
- .br
- .if \n(.$<2 .in +0.8i
- .if \n(.$>1 .in +$2
- ..
- .\" ----------------------------------------------------------------------- HP
- .\" indented paragraph with hanging indent, no tag. first resets absolute ind.
- .\"
- .de HP
- .br
- .if \nD>0 \{\
- . sp \nD
- \}
- .in 0.8i
- .in +\nI
- .ie \n(.$=0 \{\
- . in +0.8i
- . ti -0.8i
- \}
- .el \{\
- . in +$1
- . ti -$1
- \}
- ..
- .\" ----------------------------------------------------------------------- RP
- .\" relative indented paragraph with tag. MUST end with .RE
- .\"
- .de RP
- .br
- .if \nD>0 \{\
- . sp \nD
- \}
- \&$1
- .br
- .if \n(.$<2 \{\
- . in +0.8i
- \}
- .if \n(.$>1 \{\
- . in +$2
- \}
- ..
- .\" ----------------------------------------------------------------------- pp
- .\" start a new indented paragraph
- .\"
- .de pp
- .if \nD>0 \{\
- . sp \nD
- \}
- .in 0.8i
- .nr I 0
- .ti +0.8i
- ..
- .\" ----------------------------------------------------------------------- PP
- .\" start a new unindented paragraph
- .\"
- .de PP
- .if \nD>0 \{\
- . sp \nD
- \}
- .in 0.8i
- .nr I 0
- ..
- .\" ----------------------------------------------------------------------- LP
- .\" start a new unindented paragraph (same as PP)
- .\"
- .de LP
- .if \nD>0 \{\
- . sp \nD
- \}
- .in 0.8i
- .nr I 0
- ..
- .\" ----------------------------------------------------------------------- SH
- .\" main section heading
- .\"
- .de SH
- .if \n(.$<1 \{\
- . sp 2
- \&\*(Me: FATAL ERROR, too few args for SH
- . sp 2
- . ex
- \}
- .sp 1
- .ne 3
- .in 0.8i
- .nr D 1
- .nr I 0
- .ti -0.8i
- .ie \nM>0 \{\
- . if \n(.$=1 \&\fB$1\fR
- . if \n(.$=2 \&\fB$1\fR \fB$2\fR
- . if \n(.$=3 \&\fB$1\fR \fB$2\fR \fB$3\fR
- . if \n(.$=4 \&\fB$1\fR \fB$2\fR \fB$3\fR \fB$4\fR
- . if \n(.$=5 \&\fB$1\fR \fB$2\fR \fB$3\fR \fB$4\fR \fB$5\fR
- . if \n(.$=6 \&\fB$1\fR \fB$2\fR \fB$3\fR \fB$4\fR \fB$5\fR \fB$6\fR
- \}
- .el \&$1 $2 $3 $4 $5 $6
- .br
- ..
- .\" ----------------------------------------------------------------------- SS
- .\" subsection heading, same indent
- .\"
- .de SS
- .if \n(.$<1 \{\
- . sp 2
- \&\*(Me: FATAL ERROR, too few args for SS
- . sp 2
- . ex
- \}
- .sp 1
- .ne 3
- .in 0.8i
- .nr D 1
- .nr I 0
- .ie \nM>0 \{\
- . if \n(.$=1 \&\fB$1\fR
- . if \n(.$=2 \&\fB$1\fR \fB$2\fR
- . if \n(.$=3 \&\fB$1\fR \fB$2\fR \fB$3\fR
- . if \n(.$=4 \&\fB$1\fR \fB$2\fR \fB$3\fR \fB$4\fR
- . if \n(.$=5 \&\fB$1\fR \fB$2\fR \fB$3\fR \fB$4\fR \fB$5\fR
- . if \n(.$=6 \&\fB$1\fR \fB$2\fR \fB$3\fR \fB$4\fR \fB$5\fR \fB$6\fR
- \}
- .el \&$1 $2 $3 $4 $5 $6
- .sp
- ..
- .\" ----------------------------------------------------------------------- IX
- .\" make index entry (ignored by this nroff...)
- .\"
- .de IX
- .tm \&$1 \n%
- ..
- .de CX
- .tm \&$1 \n%
- ..
- .\"
- .\"
- .\" font switching macros...
- .\"
- .\"
- .\"
- .\" ----------------------------------------------------------------------- I
- .\" italic text (must handle at least 2 args)
- .\"
- .de I
- .ie \nM>0 \{\
- . if \n(.$<1 \&\fI
- . if \n(.$=1 \&\fI$1\fR
- . if \n(.$=2 \&\fI$1$2\fR
- . if \n(.$=3 \&\fI$1$2$3\fR
- . if \n(.$=4 \&\fI$1$2$3$4\fR
- . if \n(.$=5 \&\fI$1$2$3$4$5\fR
- . if \n(.$=6 \&\fI$1$2$3$4$5$6\fR
- \}
- .el \&$1$2$3$4$5$6
- ..
- .\" ----------------------------------------------------------------------- B
- .\" bold text (must handle at least 2 args)
- .\"
- .de B
- .ie \nM>0 \{\
- . if \n(.$<1 \&\fB
- . if \n(.$=1 \&\fB$1\fR
- . if \n(.$=2 \&\fB$1$2\fR
- . if \n(.$=3 \&\fB$1$2$3\fR
- . if \n(.$=4 \&\fB$1$2$3$4\fR
- . if \n(.$=5 \&\fB$1$2$3$4$5\fR
- . if \n(.$=6 \&\fB$1$2$3$4$5$6\fR
- \}
- .el \&$1$2$3$4$5$6
- ..
- .\" ----------------------------------------------------------------------- R
- .\" Roman text
- .\"
- .de R
- .ie \nM>0 \{\
- . if \n(.$<1 \&\fR
- . if \n(.$=1 \&\fR$1
- . if \n(.$=2 \&\fR$1$2
- . if \n(.$=3 \&\fR$1$2$3
- . if \n(.$=4 \&\fR$1$2$3$4
- . if \n(.$=5 \&\fR$1$2$3$4$5
- . if \n(.$=6 \&\fR$1$2$3$4$5$6
- \}
- .el \&$1$2$3$4$5$6
- ..
- .\" ----------------------------------------------------------------------- SM
- .\" small text (note: this only works with manpager!!!)
- .\"
- .de SM
- .ie \nM>0 \{\
- . if \n(.$<1 \&\s-2
- . if \n(.$=1 \&\s-2$1\s0
- . if \n(.$=2 \&\s-2$1$2\s0
- . if \n(.$=3 \&\s-2$1$2$3\s0
- . if \n(.$=4 \&\s-2$1$2$3$4\s0
- . if \n(.$=5 \&\s-2$1$2$3$4$5\s0
- . if \n(.$=6 \&\s-2$1$2$3$4$5$6\s0
- \}
- .el \&$1$2$3$4$5$6
- ..
- .\" ----------------------------------------------------------------------- IR
- .\" alternate italic and Roman text (must handle at least 6 args)
- .\"
- .de IR
- .ie \nM>0 \{\
- . if \n(.$=1 \&\fI$1\fR
- . if \n(.$=2 \&\fI$1\fR$2
- . if \n(.$=3 \&\fI$1\fR$2\fI$3\fR
- . if \n(.$=4 \&\fI$1\fR$2\fI$3\fR$4
- . if \n(.$=5 \&\fI$1\fR$2\fI$3\fR$4\fI$5\fR
- . if \n(.$=6 \&\fI$1\fR$2\fI$3\fR$4\fI$5\fR$6
- \}
- .el \&$1$2$3$4$5$6
- ..
- .\" ----------------------------------------------------------------------- RI
- .\" alternate Roman and italic text (must handle at least 6 args)
- .\"
- .de RI
- .ie \nM>0 \{\
- . if \n(.$=1 \&\fR$1
- . if \n(.$=2 \&\fR$1\fI$2\fR
- . if \n(.$=3 \&\fR$1\fI$2\fR$3
- . if \n(.$=4 \&\fR$1\fI$2\fR$3\fI$4\fR
- . if \n(.$=5 \&\fR$1\fI$2\fR$3\fI$4\fR$5
- . if \n(.$=6 \&\fR$1\fI$2\fR$3\fI$4\fR$5\fI$6\fR
- \}
- .el \&$1$2$3$4$5$6
- ..
- .\" ----------------------------------------------------------------------- BR
- .\" alternate bold and Roman text (must handle at least 6 args)
- .\"
- .de BR
- .ie \nM>0 \{\
- . if \n(.$=1 \&\fB$1\fR
- . if \n(.$=2 \&\fB$1\fR$2
- . if \n(.$=3 \&\fB$1\fR$2\fB$3\fR
- . if \n(.$=4 \&\fB$1\fR$2\fB$3\fR$4
- . if \n(.$=5 \&\fB$1\fR$2\fB$3\fR$4\fB$5\fR
- . if \n(.$=6 \&\fB$1\fR$2\fB$3\fR$4\fB$5\fR$6
- \}
- .el \&$1$2$3$4$5$6
- ..
- .\" ----------------------------------------------------------------------- RB
- .\" alternate Roman and bold text (must handle at least 6 args)
- .\"
- .de RB
- .ie \nM>0 \{\
- . if \n(.$=1 \&\fR$1
- . if \n(.$=2 \&\fR$1\fB$2\fR
- . if \n(.$=3 \&\fR$1\fB$2\fR$3
- . if \n(.$=4 \&\fR$1\fB$2\fR$3\fB$4\fR
- . if \n(.$=5 \&\fR$1\fB$2\fR$3\fB$4\fR$5
- . if \n(.$=6 \&\fR$1\fB$2\fR$3\fB$4\fR$5\fB$6\fR
- \}
- .el \&$1$2$3$4$5$6
- ..
- .\" ----------------------------------------------------------------------- BI
- .\" alternate bold and italic text (must handle at least 6 args)
- .\"
- .de BI
- .ie \nM>0 \{\
- . if \n(.$=1 \&\fB$1\fR
- . if \n(.$=2 \&\fB$1\fI$2\fR
- . if \n(.$=3 \&\fB$1\fI$2\fB$3\fR
- . if \n(.$=4 \&\fB$1\fI$2\fB$3\fI$4\fR
- . if \n(.$=5 \&\fB$1\fI$2\fB$3\fI$4\fB$5\fR
- . if \n(.$=6 \&\fB$1\fI$2\fB$3\fI$4\fB$5\fI$6\fR
- \}
- .el \&$1$2$3$4$5$6
- ..
- .\" ----------------------------------------------------------------------- IB
- .\" alternate italic and bold text (must handle at least 6 args)
- .\"
- .de IB
- .ie \nM>0 \{\
- . if \n(.$=1 \&\fI$1\fR
- . if \n(.$=2 \&\fI$1\fB$2\fR
- . if \n(.$=3 \&\fI$1\fB$2\fI$3\fR
- . if \n(.$=4 \&\fI$1\fB$2\fI$3\fB$4\fR
- . if \n(.$=5 \&\fI$1\fB$2\fI$3\fB$4\fI$5\fR
- . if \n(.$=6 \&\fI$1\fB$2\fI$3\fB$4\fI$5\fB$6\fR
- \}
- .el \&$1$2$3$4$5$6
- ..
- .\"
- .\"
- .\"
- .\"
- .\" ----------------------------------------------------------------------- }D
- .\" debug. use (e.g. print current indent):
- .\"
- .\" .}D .br
- .\" .}D "** DEBUG ** before RS \n(.i"
- .\"
- .de }D
- .if \nZ>0 \&$1 $2 $3 $4 $5 $6 $7 $8
- ..
- .\"
- .\"
- .\" print macros first if debugging...
- .if \nZ>0 \{\
- . sp 2
- Macros Defined:
- . sp 2
- . pm T
- . sp 2
- End Macro Definitions.
- . sp 4
- \}
- .\"
- .\" end of tmac.an
-